home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / BULLETIN / 1484B.ZIP / ACTUP.DOC < prev    next >
Text File  |  1989-01-02  |  7KB  |  197 lines
  1.  
  2.                             ICON SOFTWARE DIVISION
  3.                             ----------------------
  4.                             ACTUP.EXE VERSION 1.35
  5.                        ---------------------------------
  6.                         WRITTEN BY EDWARD J. REGGI 9/88
  7.                                UPDATE 12/15/88
  8.  
  9.  
  10.    Purpose:
  11.    --------     ACTUP (ACTivity Utility Processor) was designed for two
  12.                 main reasons :
  13.  
  14.                          1. To "Decode" the ACTIVITY.LOG file into easy
  15.                             and plain old english.
  16.                          2. To create DAILY call logs out of ONE big
  17.                             ACTIVITY.LOG.
  18.  
  19.    Whats New:
  20.    ----------   The New Actup is just the same as the old execept that 
  21.                 it now when using the "&" command it will prints users
  22.                 that logged in on ONE line per call.
  23.                 It is much easier to read!
  24.  
  25.                  
  26.  
  27.    Format:
  28.    -------      To use ACTUP.EXE you must have it in the same Path/Directory
  29.                 that the ACTIVITY.LOG is in.
  30.  
  31.                 The format to RUN ACTUP is very simple.
  32.  
  33.                 C>ACTUP {-F} {-T} {-O} { [filename] } {-U}
  34.  
  35.                 The commands are also simple to understand. Also one should
  36.                 note that every field (Except {-U} Username) can be placed
  37.                 anywhere on the COMMAND line. ONLY the Username field must be
  38.                 LAST! More on that later.
  39.  
  40.                 The Fields are described below:
  41.  
  42.      {-F}...... This field is called the FROM field. The format is just a
  43.                 standard DATE string. Ex: -F 09/21/88
  44.                 The FROM field tells ACTUP where to start the search.
  45.                 If you use the GLOBAL command @ (SHIFT-2) here then the
  46.                 computer uses the current DATE setting.
  47.                 Or use **/**/** to start at the TOP of the Activity log.
  48.                 (CONSULT DOS BOOK TO SET CURRENT DATE)
  49.  
  50.      {-T}...... This field is called the TO field. The format is also just a
  51.                 standard DATE string. Ex: -T 09/21/88
  52.                 The TO field tells ACTUP where to stop the search.
  53.                 If you use the GLOBAL command @ (SHIFT-2) here then the
  54.                 computer uses the current DATE setting.
  55.                 Or use **/**/** to stop at the BOTTOM of the Activity log.
  56.                 (CONSULT DOS BOOK TO SET CURRENT DATE)
  57.  
  58.      {-O}...... This field is called the OUTPUT field. ACTUP will only
  59.                 accept 2 types of output.
  60.  
  61.                        1. D : For Direct Screen output {FAST}
  62.                        2. T : BIOS output routine      {SLOW}
  63.  
  64.                  If not specified the computer DEFAULTS to {-O D}
  65.                  For DOOR use, then send a {-O T}
  66.  
  67.      [Filename]  If ACTUP finds and open bracket and a closed one, then
  68.                  whatever is in the middle becomes the OUTPUT filename.
  69.                  One can include path and extension. The file is just a
  70.                  plain ASCII file.
  71.  
  72.      {-U}....... This field is called the USERS NAME field.
  73.                  IT MUST BE THE LAST FIELD ON THE COMMAND LINE!
  74.                  ACTUP will default to an asterisk (*) if this field
  75.                  is not specified. Asterisk will show ALL usernames!
  76.  
  77.      NOTES   :   All fields have DEFAULTS. Which mean that if you dont
  78.                  send them, ACTUP will assign each one.
  79.  
  80.                     Command             DEFAULT
  81.                     ----------------------------
  82.                        -F               **/**/**
  83.                        -T               **/**/**
  84.                        -O               D
  85.                        -U               *
  86.  
  87.                   In addition to the defaults there are PREDEFINED flag
  88.                   symbols:
  89.  
  90.                      Symbol             ACTION
  91.                      ----------------------------------------
  92.                        @                Equals CURRENT DATE
  93.                      [...]              Where ... = filename
  94.                        &                Does DAILY.LOG
  95.                        ?                Displays Instructions
  96.  
  97.  
  98.    Samples:
  99.    --------    Here are some samples and their action:
  100.  
  101.                C>ACTUP -T 09/19/88 -O T
  102.  
  103.                Will display output via BIOS print routines, and start
  104.                searching at FIRST record in ACTIVITY and stop at 09/19/88
  105.  
  106.                C>ACTUP
  107.  
  108.                Everything gets DEFAULTed. Basically the current ACTIVITY
  109.                file will be shown.
  110.  
  111.                C>ACTUP -T @ -U ARNOLD ARCE
  112.  
  113.                ACTUP will search, starting with the FIRST record and
  114.                eventually end on the CURRENT DATE! The search is
  115.                only displaying ARNOLD ARCE's info.
  116.  
  117.                C>ACTUP &
  118.  
  119.                ACTUP will store the last calls in the past 24 hours.
  120.                To a ASCII file , DAILY.LOG
  121.  
  122.  
  123.  
  124.    Note:
  125.    -----      This version of ACTUP only works with 1.29 and higher
  126.               Versions of Searchlight BBS
  127.  
  128.  
  129.  
  130.    Software Regulations:
  131.    ---------------------
  132.  
  133.      This software is copyrighted, but is placed under the PUBLIC DOMAIN
  134.      catergory. ICON Software allows users to distribute this material AS IS!
  135.      Any alterations or extra files in the ARC are not permitted.
  136.  
  137.      We suggest if you use this program alot we would like a donation of $10
  138.      If you send a donation, we will send you the next version of ACTUP.
  139.           (Make all CHECKS or MONEY ORDERS payable to Edward Reggi)
  140.  
  141.  
  142.    Disclaimer:
  143.    -----------
  144.  
  145.      If the original ARC or any file within the ARC is altered, We do not
  146.      take the responsibility of ANY TYPE OF damage that then may occur.
  147.      Even though at ICON Software we test each version of ACTUP on many
  148.      Searchlight versions, some newer versions in the future may not work
  149.      with ACTUP Ver 1.34
  150.  
  151.  
  152.    Acknowledgements:
  153.    -----------------
  154.  
  155.      - Turbo Pascal is a trademark of Borland International, INC.
  156.      - ICON Software is a Division of the IBM Communications Orientated Network.
  157.      - MS-DOS is a trademark of Microsoft Corporation.
  158.      - Searchlight BBS is a trademark of Searchlight Software.
  159.      - IBM is a trademark of Internation Business Machines Corp.
  160.      - PKARC & PKXARC are trademarks of PWARE Inc.
  161.  
  162.  
  163.    Thanks:
  164.    -------
  165.  
  166.      I would like to personally thank:
  167.  
  168.       - Kelvin Natal, Richard Kirschner, and all SEARCHLIGHT SYSOPS.
  169.  
  170.  
  171.  
  172.            For help on ACTUP or any other ICON software product call :
  173.  
  174.                   The Emerald Forest BBS   -   718-339-1352
  175.  
  176.  
  177.  
  178.                   Thanks again for supporting ICON Software!
  179.  
  180.  
  181.   I feel that ACTUP is a nifty little program for all sysops to use. Even
  182.   though it is still Public Domain.. I would even appreciate $5. Since it
  183.   can go towards many more newer ICON SOFTWARE projects.. Plus it puts you
  184.   on our mailing list! Thanks again!
  185.  
  186.                        Send donations or questions to:
  187.  
  188.                          Edward Joseph Reggi
  189.                          1204 Chestnut Avenue
  190.                          Brooklyn, New York 11230
  191.  
  192.  
  193.     ACTUP.EXE  Ver 1.35  Copyright 12/1988  Edward J. Reggi  ICON SOFTWARE
  194.  
  195.  
  196.  
  197.